home *** CD-ROM | disk | FTP | other *** search
/ Die Ultimative Software-P…i Collection 1996 & 1997 / Die Ultimative Software-Pakete CD-ROM fur Atari Collection 1996 & 1997.iso / g / gnu_c / mnthlb44.zoo / 00readme next >
Encoding:
Text File  |  1994-03-07  |  3.8 KB  |  106 lines
  1. MiNT library for Heat-n-Serve/Sozobon C, patchlevel 44.
  2.  
  3. This is a port of Eric Smith's MiNT library to Heat-n-Serve C, based on
  4. Dave Gymer's original port.  It replaces the files dlibs.a, dstart.o,
  5. and libm.a from the original Heat-n-Serve distribution, and includes a
  6. simple termcap library.
  7.  
  8. A reminder, you _will_ need the pl44 include files to use this library.
  9. These can be found where you found this archive, in the file
  10. mntinc44.zoo or similar.
  11.  
  12. WHAT'S HERE:
  13.  
  14.     00readme
  15.     This file.
  16.     cmprss.ttp
  17.     A utility by Thorsten Roskowetz to shrink osbind.h somewhat.
  18.     dlibs.a
  19.     dstart.o
  20.     MiNT-aware replacements for the Heat-n-Serve distribution files
  21.     of the same name.
  22.     libm.a
  23.     Floating point support.  Actually, this is identical to the
  24.     libm.a from the original Heat-n-Serve distribution, except that
  25.     the floating-point stdio routines have been recompiled with the
  26.     MiNT headers (since dLibs and the MiNTlibs disagree on the shape
  27.     of a FILE).
  28.     libtermcap.a
  29.     A simple termcap library.
  30.  
  31.     NOTE:  All of the above use short external identifiers and are
  32.     hence compatible with HSC v1.40 and earlier.  When (if?) Ian
  33.     releases v2.00 or higher, I will release a compatible library.
  34.  
  35.     patch/
  36.     Stuff you'll need if you want to start playing around with the
  37.     library source.
  38.  
  39. IF YOU JUST WANT TO USE IT:
  40.  
  41. To get yourself up and running with the MiNTlibs, do the following:
  42.  
  43. 0)  Obtain and install the MiNT include files for this version.
  44.  
  45. 1)  Copy the files dlibs.a, dstart.o, libm.a and libtermcap.a to the
  46.     directory where your MiNT library will live.  Also copy the files
  47.     vdifast.a and aesfast.a from the Heat-n-Serve distribution to this
  48.     directory.
  49.  
  50. 2)  Rename the include file osbind.h to osbind.hx and run cmprss.ttp
  51.     with the options "-o osbind.h osbind.hx".  This removes superfluous
  52.     whitespace from osbind.h, so that the extremely long lines don't
  53.     choke HSC's static line buffer.
  54.  
  55. 3)  Replace the gemfast.h from the MiNT include distribution with the
  56.     one from the Heat-n-Serve distribution.
  57.  
  58. 4)  Set the environment variables LIB and INCLUDE to point to your MiNT
  59.     library directory and MiNT include files directory, respectively.
  60.  
  61. And you're ready to roll!  The MiNT library is a complete replacement
  62. for dLibs, but if you should need to switch back temporarily, you can
  63. simply change LIB and INCLUDE appropriately.
  64.  
  65. IF YOU WANT TO PLAY WITH IT:
  66.  
  67. Ah, the hacker type, eh?  Okay, here's how to update the pl44 source
  68. release to HSC pl44:
  69.  
  70. 0)  Obtain and install the MiNT library source distribution for this
  71.     version.  Also obtain the following programs from atari.archive:
  72.  
  73.     patch    To install the enclosed diffs
  74.     cpp        \
  75.     mit2mot    / To build the .cpp files
  76.  
  77. 1)  Apply the patches in patch/code44.diffs from this archive using patch
  78.     (alternatively, you could apply the patches by hand; the format of
  79.     the context diffs is pretty easy to understand).
  80.  
  81. 2)  Place the programs cpp.ttp and mit2mot.ttp somewhere that make can
  82.     find them.
  83.  
  84. 3)  In the main source directory, delete all files beginning with `_',
  85.     as well as alglobal.c, linea.c and inistack.c.  Copy all the .s
  86.     files from sozobon/, as well as termcap.c and makefile, to the main
  87.     source directory.
  88.  
  89. 4)  Type `make'.  Go watch a movie. ;)
  90.  
  91. You should now have files dlibs.a, dstart.o and libtermcap.a, which
  92. should be identical to the ones in this package.
  93.  
  94. DISCLAIMER:
  95.  
  96. What, you were expecting an ironclad guarantee of performance? ;)  Okay,
  97. while I have built several large programs with this library with no
  98. problems, I can't guarantee that there aren't still a few bugs lurking
  99. around in the code.  Caveat emptor, use at your own risk, and all that
  100. jazz.  And if you should happen to find a bug, please notify me at the
  101. address below.
  102.  
  103. Have fun!
  104.  
  105. Scott Bigham                dsb@cs.duke.edu
  106.